home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / MPI_Recv.z / MPI_Recv
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPIIII____RRRREEEECCCCVVVV((((3333))))                                                        MMMMPPPPIIII____RRRREEEECCCCVVVV((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      MMMMPPPPIIII____RRRReeeeccccvvvv - Provides a basic receive operation
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      C:
  13.  
  14.           #include <mpi.h>
  15.  
  16.           int MPI_Recv( _b_u_f, _c_o_u_n_t, _d_a_t_a_t_y_p_e, _s_o_u_r_c_e,
  17.           _t_a_g, _c_o_m_m, _s_t_a_t_u_s )
  18.           void             *_b_u_f;
  19.           int              _c_o_u_n_t, _s_o_u_r_c_e, _t_a_g;
  20.           MPI_Datatype     _d_a_t_a_t_y_p_e;
  21.           MPI_Comm         _c_o_m_m;
  22.           MPI_Status       *_s_t_a_t_u_s;
  23.  
  24.  
  25.      C++:
  26.  
  27.           #include <mpi.h>
  28.  
  29.           void Comm::Recv(
  30.           void*             _b_u_f,
  31.           int               _c_o_u_n_t,
  32.           const Datatype&   _d_a_t_a_t_y_p_e,
  33.           int               _s_o_u_r_c_e,
  34.           int               _t_a_g) const
  35.  
  36.  
  37.      Fortran:
  38.  
  39.           INCLUDE "mpif.h" (or USE MPI)
  40.  
  41.           <type> BUF(*)
  42.           INTEGER _c_o_u_n_t, _d_a_t_a_t_y_p_e, _s_o_u_r_c_e, _t_a_g, _c_o_m_m,
  43.           _s_t_a_t_u_s(MPI_STATUS_SIZE), _i_e_r_r_o_r
  44.  
  45.           CALL MPI_RECV(_b_u_f, _c_o_u_n_t, _d_a_t_a_t_y_p_e, _s_o_u_r_c_e, _t_a_g, _c_o_m_m,
  46.           _s_t_a_t_u_s(MPI_STATUS_SIZE), _i_e_r_r_o_r)
  47.  
  48.  
  49. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDDSSSS
  50.      This release implements the MPI 1.2 standard, as documented by the MPI
  51.      Forum in the spring 1997 release of _M_P_I:  _A _M_e_s_s_a_g_e _P_a_s_s_i_n_g _I_n_t_e_r_f_a_c_e
  52.      _S_t_a_n_d_a_r_d.
  53.  
  54. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.      The MMMMPPPPIIII____RRRReeeeccccvvvv routine provides a basic receive operation.  This routine
  56.      accepts the following parameters:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPIIII____RRRREEEECCCCVVVV((((3333))))                                                        MMMMPPPPIIII____RRRREEEECCCCVVVV((((3333))))
  71.  
  72.  
  73.  
  74.      _b_u_f       Returns the initial address of the receive buffer (choice)
  75.  
  76.      _s_t_a_t_u_s    Returns the status object (status)
  77.  
  78.      _c_o_u_n_t     Specifies the maximum number of elements in the receive buffer
  79.                (integer)
  80.  
  81.      _d_a_t_a_t_y_p_e  Specifies the data type of each receive buffer element (handle)
  82.  
  83.      _s_o_u_r_c_e    Specifies the rank of the source (integer)
  84.  
  85.      _t_a_g       Specifies the message tag (integer)
  86.  
  87.      _c_o_m_m      Specifies the communicator (handle)
  88.  
  89.      _i_e_r_r_o_r    Specifies the return code value for successful completion,
  90.                which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the mmmmppppiiiiffff....hhhh
  91.                file.
  92.  
  93. NNNNOOOOTTTTEEEESSSS
  94.      The _c_o_u_n_t parameter indicates the maximum length of a message; you can
  95.      determine the actual number by using MMMMPPPPIIII____GGGGeeeetttt____ccccoooouuuunnnntttt.
  96.  
  97.      All Fortran MPI routines (except for MMMMPPPPIIII____WWWWttttiiiimmmmeeee(3) and MMMMPPPPIIII____WWWWttttiiiicccckkkk(3)) have
  98.      an additional _i_e_r_r argument at the end of the argument list.  _i_e_r_r is an
  99.      integer and has the same meaning as the return value of the routine in C.
  100.      In Fortran, MPI routines are subroutines and are invoked with the CCCCAAAALLLLLLLL
  101.      statement.  Additionally, all MPI objects (for example, MMMMPPPPIIII____DDDDaaaattttaaaattttyyyyppppeeee and
  102.      MMMMPPPPIIII____CCCCoooommmmmmmm) are of type integer.
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      MMMMPPPPIIII____IIIIrrrreeeeccccvvvv(3), MMMMPPPPIIII____GGGGeeeetttt____ccccoooouuuunnnntttt(3), MMMMPPPPIIII____WWWWttttiiiimmmmeeee(3), MMMMPPPPIIII____WWWWttttiiiicccckkkk(3)
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.